Splash screen sample


Windows Runtime, Windows 8.1, Windows Phone 8.1
User Interface, universal app
Windows RT
en-US
4/2/2014
View this sample online

This sample shows how to imitate the splash screen that Windows displays for your app by positioning a similar image correctly when Windows dismisses the splash screen that it displays. This sample uses the SplashScreen class in the Windows.ApplicationModel.Activation namespace.

Note  This sample was created using one of the universal app templates available in Visual Studio. It shows how its solution is structured so it can run on both Windows 8.1 and Windows Phone 8.1. For more info about how to build apps that target Windows and Windows Phone with Visual Studio, see Build apps that target Windows and Windows Phone 8.1 by using Visual Studio.

The sample demonstrates these tasks:

  1. Responding when the splash screen dismissed event fires

  2. Extending the splash screen

Important APIs in this sample include:

Related topics

Windows 8 app samples
Adding a splash screen (Windows Runtime apps using JavaScript and HTML)
Adding a splash screen (Windows Runtime apps using C#/VB/C++ and XAML)
Related samples
App activate and suspend using WinJS sample
App activated, resume, and suspend using the WRL sample

Related technologies

Windows.ApplicationModel.Activation.SplashScreen class

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2
Phone
Windows Phone 8.1

Build the sample

  1. Start Microsoft Visual Studio 2013 Update 2 and select File > Open > Project/Solution.
  2. Go to the directory to which you unzipped the sample. Then go to the subdirectory named for the sample and double-click the Visual Studio 2013 Update 2 Solution (.sln) file.
  3. Follow the steps for the version of the sample you want:

    • To build the Windows version of the sample:

      1. Select SplashScreenSample.Windows in Solution Explorer.
      2. Press Ctrl+Shift+B, or use Build > Build Solution, or use Build > Build SplashScreenSample.Windows.

    • To build the Windows Phone version of the sample:

      1. Select SplashScreenSample.WindowsPhone in Solution Explorer.
      2. Press Ctrl+Shift+B or use Build > Build Solution or use Build > Build SplashScreenSample.WindowsPhone.

Run the sample

The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.

Deploying the sample

  • To deploy the built Windows version of the sample:

    1. Select SplashScreenSample.Windows in Solution Explorer.
    2. Use Build > Deploy Solution or Build > Deploy SplashScreenSample.Windows.

  • To deploy the built Windows Phone version of the sample:

    1. Select SplashScreenSample.WindowsPhone in Solution Explorer.
    2. Use Build > Deploy Solution or Build > Deploy SplashScreenSample.WindowsPhone.

Deploying and running the sample

  • To deploy and run the Windows version of the sample:

    1. Right-click SplashScreenSample.Windows in Solution Explorer and select Set as StartUp Project.
    2. To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.

  • To deploy and run the Windows Phone version of the sample:

    1. Right-click SplashScreenSample.WindowsPhone in Solution Explorer and select Set as StartUp Project.
    2. To debug the sample and then run it, press F5 or use Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.